Drop gtk_true and gtk_false

These functions are entirely trivial, their documentation
is much longer than their implementation, and it contains
an example that is annotated as "don't do this"...

diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt
index efa3d4f9e35856fa26e2d6a78a6bf985d65dbb8f..658504401edbc653792e24ef08bd73e1d72b2c5a 100644 (file)
--- a/docs/reference/gtk/gtk4-sections.txt
+++ b/docs/reference/gtk/gtk4-sections.txt
@@ -4814,10 +4814,6 @@ gtk_main_do_event
 GtkModuleInitFunc
 GtkModuleDisplayInitFunc
 
-<SUBSECTION>
-gtk_true
-gtk_false
-
 <SUBSECTION>
 gtk_grab_add
 gtk_grab_get_current

diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index c0e299f180c509df608ff8d462b30111861709f4..fcd1f363bcfe8fee66fac4381edf75b0beea1cda 100644 (file)
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -1906,73 +1906,6 @@ gtk_main_do_event (GdkEvent *event)
     g_object_unref (rewritten_event);
 }
 
-/**
- * gtk_true:
- *
- * All this function does it to return %TRUE.
- *
- * This can be useful for example if you want to inhibit the deletion
- * of a window. Of course you should not do this as the user expects
- * a reaction from clicking the close icon of the window...
- *
- * ## A persistent window
- *
- * |[<!-- language="C" -->
- * #include <gtk/gtk.h>
- *
- * int
- * main (int argc, char **argv)
- * {
- *   GtkWidget *win, *but;
- *   const char *text = "Close yourself. I mean it!";
- *
- *   gtk_init (&argc, &argv);
- *
- *   win = gtk_window_new (GTK_WINDOW_TOPLEVEL);
- *   g_signal_connect (win,
- *                     "delete-event",
- *                     G_CALLBACK (gtk_true),
- *                     NULL);
- *   g_signal_connect (win, "destroy",
- *                     G_CALLBACK (gtk_main_quit),
- *                     NULL);
- *
- *   but = gtk_button_new_with_label (text);
- *   g_signal_connect_swapped (but, "clicked",
- *                             G_CALLBACK (gtk_object_destroy),
- *                             win);
- *   gtk_container_add (GTK_CONTAINER (win), but);
- *
- *   gtk_widget_show (win);
- *
- *   gtk_main ();
- *
- *   return 0;
- * }
- * ]|
- *
- * Returns: %TRUE
- */
-gboolean
-gtk_true (void)
-{
-  return TRUE;
-}
-
-/**
- * gtk_false:
- *
- * Analogical to gtk_true(), this function does nothing
- * but always returns %FALSE.
- *
- * Returns: %FALSE
- */
-gboolean
-gtk_false (void)
-{
-  return FALSE;
-}
-
 static GtkWindowGroup *
 gtk_main_get_window_group (GtkWidget *widget)
 {

diff --git a/gtk/gtkmain.h b/gtk/gtkmain.h
index 726b14650fa75b751ece1f756877c510f75bf8a6..2a161198aef849f4489492605ae4c252aba8be33 100644 (file)
--- a/gtk/gtkmain.h
+++ b/gtk/gtkmain.h
@@ -119,11 +119,6 @@ gboolean   gtk_main_iteration      (void);
 GDK_AVAILABLE_IN_ALL
 gboolean   gtk_main_iteration_do   (gboolean            blocking);
 
-GDK_AVAILABLE_IN_ALL
-gboolean   gtk_true                (void) G_GNUC_CONST;
-GDK_AVAILABLE_IN_ALL
-gboolean   gtk_false               (void) G_GNUC_CONST;
-
 GDK_AVAILABLE_IN_ALL
 void       gtk_grab_add            (GtkWidget          *widget);
 GDK_AVAILABLE_IN_ALL